home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / utilities / _customise / clocks / _roughtime / _help next >
Encoding:
Text File  |  1993-01-07  |  9.7 KB  |  182 lines
  1. RoughTime 4.19 (13-Dec-1992)
  2. ============================
  3.  
  4. (c) Jon Ribbens of Doggysoft, 1992
  5.  
  6.  
  7. This program may be freely distributed as long as you don't make any money
  8. out of doing so, and as long as all the files are included and are unaltered.
  9. If you alter it or try to make money out of it then you're probably breaking
  10. the law (at least, that's the idea).
  11. There is no warranty, express, implied or anything, that this program will do
  12. anything at all, that it will work as described, that it won't do things that
  13. are not described, or that it won't run off and sob quietly in a corner.
  14. I CAN tell you that it hasn't done this while I've been using it, however.
  15.  
  16.  
  17. Instructions
  18. ------------
  19.  
  20. Double-click on the icon to load it, it will pop up a window near the icon
  21. bar... It says the time to the nearest five minutes. To move the window
  22. about, treat the entire window as if it were its own title bar - click select
  23. on it to bring it to the front, drag adjust to move it, and drag select to
  24. bring it to the front and move it.
  25.  
  26. This version is a yet another complete rewrite since the previous released
  27. one (and there was an unreleased complete re-write inbetween times). It is
  28. entirely written in assembler, is a module task and now has alarms. This
  29. means that it takes only a little bit more memory (less on a 4Meg machine)
  30. than before - now about 29k - and will stick around if you quit the desktop.
  31. It now uses my WimpExtension module, which, if you don't have version 1.69 or
  32. later already, should be moved from this directory into the !System.Modules
  33. directory.
  34.  
  35. To use the 'Rough Alarms', click MENU on the time display window and select
  36. 'Alarm'. A window will open with an inner linked window. You can have up to
  37. 32 alarms, numbered 0-31. Select the slot with the icons at the top. Each
  38. alarm will only be enabled if the radio button next to this is on.
  39. YOU MUST REMEMBER TO ENABLE YOUR ALARMS - they won't go off otherwise. In the
  40. linked window there are six sections. The top section specifies what time the
  41. alarm should go off. The arrows on the left alter the minutes in 5 minute
  42. steps, and the arrows on the right alter the hours. You can also click on
  43. 'AM' or 'PM'.
  44.  
  45. The next section specifies the date. Click on the arrows to alter the fields.
  46. Leap years and everything should be handled OK. The day of the week is
  47. displayed as a really small sprite under the date. The year can be in the
  48. range 1992-2091. (Slightly optimistic, there.)
  49.  
  50. The third section allows you to enter a message to be displayed when the
  51. alarm goes off, up to about a hundred characters.
  52.  
  53. The next section allows you to specify a repeat delay. This means that the
  54. alarm will go off when specified, and then the delay set will be added to it,
  55. and the alarm re-enabled. This means, for instance, you can set an alarm to
  56. go off every week, every other day, every year, or whatever. The repeat is
  57. only enabled if the radio button is pressed in. The units allowed are
  58. 'minutes', 'hours', 'days', 'weeks', 'months' and 'years'. On 'minutes' the
  59. amount can only be set to a multiple of 5.
  60.  
  61. The penultimate section allows you to specify 'Limited period only'. If this
  62. is on then, instead of making so the alarm goes off if the current time is
  63. any time after the alarm time, it will only go off in the period between the
  64. alarm time and a half hour later. This is useful, for example, for TV
  65. programmes - you don't really want to be told you missed something yesterday.
  66. If the alarm is found to have missed (eg. because the computer wasn't on at
  67. the alarm time) then repeating alarms will be moved forward ready for the
  68. next repeat time, and non-repeating alarms will be disabled.
  69.  
  70. The last section allows you to specify that the alarm will only go off on
  71. certain days (only really useful for repeating alarms). This means that, for
  72. example, you can set an alarm to go off every day, and then click on
  73. 'Saturday' and 'Sunday' so they're off, and the alarm will go off every
  74. weekday, but not weekends. If you have a repeating alarm cunningly set up so
  75. that it will never go off due to the 'certain days only' feature then Rough
  76. Time will give you an error message when you click 'OK', and move you back to
  77. that alarm so you can fix it (otherwise it would get all confused when it
  78. tried to advance the alarm to the next repeat date).
  79.  
  80. The button 'Reset alarm' at the bottom of the window will change the time and
  81. date of the currently displayed alarm to the current time and date, disable
  82. the alarm, clear the message field, reset the repeat, enable all the days and
  83. turn off 'limited period only'. It is suggested that you use this to clear a
  84. slot before putting a new alarm in.
  85.  
  86. There is a very minor problem with the repeat in that if you, for some
  87. foolish reason, set it (for example) to 1st Jan 1992 and have a repeat delay
  88. of 5 mins then it will take AGES to work out the next repeat time as it has
  89. to be later than the current time, so it has to skip through several months
  90. (at least) in 5 minute steps. If you accidentally get stuck like this (the
  91. hourglass will be on, and everything else will have stopped), press Escape
  92. and the alarm will be disabled. There's nothing much I can do about this;
  93. Acorn's Alarm suffers from it too, only much worse as it's in BASIC and it
  94. doesn't let you press Escape to get out of it...
  95.  
  96. The alarm will go off if the current time is equal to or later than the alarm
  97. time (unless it's a 'limited period only' one - see above). It will actually
  98. go off 2 minutes early (assuming your real-time clock is set right!), so you
  99. can set your alarm for 'about nine o'clock' every Thursday and you won't miss
  100. Harry Enfield  :-). [ Except you will now the series has finished :-( ]
  101.  
  102. When the alarm goes off, the computer will beep and a reasonably large
  103. window will appear. At the top is the time the alarm was set for. Next is the
  104. time that the alarm will next go off (if 'repeat' is enabled). Last is the
  105. message. The computer will beep every 5 seconds-ish while the window is open.
  106. There are three buttons on the right, 'OK', 'Disable' and 'Defer'. 'OK' will
  107. close the window. 'Disable' will close the window and disable the alarm. If
  108. the alarm wasn't a repeating alarm then the 'Disable' button will be shaded
  109. as clicking OK will disable it anyway.
  110.  
  111. The defer button is unshaded if the alarm wasn't a repeating alarm. If you
  112. click on it a small window will appear to let you specify a time-period. If
  113. you click 'OK' in this small window then the alarm will be pushed forward
  114. from the current time by the amount specified and re-enabled.
  115.  
  116. I've now added two extra icons in the main window, like you get on digital
  117. watches. The left hand one (which looks a bit like a bell) can be used to
  118. prevent any alarms from going off. The right hand one, if unshaded, means
  119. that the computer will make a little beepy noise every hour (a 'chime'). The
  120. settings of these icons is saved when you click 'OK' in the alarm setting
  121. window.
  122.  
  123. Rough Time now supports 'Task alarms'. These are like what I understand
  124. Alarm's task alarms to be. If the 'Message' field starts with the '¤'
  125. character (that's shift-£) then the rest of the message will be treated as
  126. an OS (star) command which can be used to start up a task, or anything else
  127. you like, really. eg.
  128.   ¤VEnd_StartScan -kill -arcfs scsi::HardDisc.$
  129. would ask VEnd to scan your hard-drive at whatever time you had set the
  130. alarm for. Or,
  131.   ¤Run scsi::HardDisc.$.Library.TidyDisc
  132. would run a file called 'TidyDisc' in the $.Library directory. Remember that
  133. if you ask Rough Time to run a non-multitasking program then the desktop will
  134. stop until that program exits.
  135.  
  136. The alarms are stored in a file '<RoughTime$Dir>.Alarms' so you can no longer
  137. just use the module on its own, you have to put it in an application
  138. directory. If Rough Time can't save the file, it won't (surprise surprise).
  139. It needs the 'ptr_write' sprite to be in the Wimp sprite pool, so this is
  140. included in the !Sprites file (it's a pretty standard sprite anyway). As
  141. Rough Time may decide to save to its alarm file at odd times (eg. when a
  142. 'limited period' alarm is detected to have missed) the BREAK key is disabled
  143. while the file is updated, to prevent you accidentally corrupting your disc.
  144.  
  145. Rough Time is now supplied in three versions - they're all the same but they
  146. have different main window styles. You can alter the !Run file to load
  147. whichever one you prefer. RoughRM1 is the normal style, RoughRM2 is a very
  148. very small window that you can, for example, squeeze at the top of the
  149. iconbar and take up practically no screen room at all, and RoughRM3 looks
  150. like it's part of the backdrop, and has the 'Back' attribute set so that
  151. other windows can't go behind it (you can't move this one around).
  152.  
  153. If you want the time display window to start in a certain place then you can
  154. include the screen coordinates in the RMRun command in the !Run file - eg if
  155. you want the window to appear at 200,800 then change the last line of the
  156. file to say 'RMRun <Obey$Dir>.RoughRM1 200,800'. This is useful if you load
  157. Rough Time in your boot sequence and you don't want to have to shift it
  158. manually across the screen every time.
  159.  
  160. If you can think of any improvements, please don't hesitate to contact me...
  161.  
  162.  
  163. Watch out for Lifeguard, an utterly brilliant screen-saver. It's sort of like
  164. AfterDark on the PC, with lots of nice effects (fireworks, stars, dancing
  165. lines, snowflakes ...). It's now on release at a Bulletin Board or PD company
  166. near you (or quite far away, it all depends on where you live really).
  167.  
  168. You MUST get yourself a copy of my WimpExtension module and the
  169. documentation, it's infinitely useful and utterly brilliant. :-)
  170.  
  171.  
  172. Money, comments, money, bug reports, demos, money, anything to me at:
  173.  
  174.                 Jon Ribbens
  175.                 39 Nutkins Way
  176.                 Chesham
  177.                 Bucks
  178.                 HP5 2BE
  179.  
  180. EMail to me Arcade BBS. It may take a little while, as I don't have a modem
  181. personally but I have a friend who does...
  182.